home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 001a / tm301_2.zip / TMSTAT.DOC < prev    next >
Text File  |  1992-01-03  |  8KB  |  202 lines
  1.  
  2. TMStat Version 3.01  3 January, 1992
  3. ===================
  4.  
  5.  
  6. Using TMStat
  7. ------------
  8.  
  9. TMStat is a small utility that takes information in TM.USE, the usage
  10. file, and produces a useful statistical report on your usage of
  11. Telemate. The command line format of TMSTAT.EXE is
  12.  
  13.     TMStat [usage.USE] [phone.FON] [/ddd] [/LDnnn.nn] [/p]
  14.  
  15.     usage.USE : uses a different usage file instead of TM.USE
  16.     phone.FON : uses a different phone directory instead of TM.FON
  17.     /ddd      : reports for the last ddd days
  18.     /LDnnn.nn : calculates long distance charge nnn.nn per minute
  19.     /p        : pauses after each screenful of information
  20.  
  21. where <usage.USE> is the name of the usage file, default is TM.USE,
  22. <phone.FON> is the name of the phone directory, default is TM.FON and
  23. <ddd> refers to the last <ddd> days to report on. The '/LD' option
  24. estimates how much it cost if <nnn.nn> dollar per minute is charged in
  25. long distance service. The '/p' option pauses the display after
  26. each screenful of information.
  27.  
  28. For example, if you would like  TMSTAT to compile a report with long
  29. distance evaluation on your usage for the past week you would type at
  30. the DOS command line:
  31.  
  32.       TMStat TM.USE /7 /LD0.25 /p
  33.  
  34. Below is a sample report for a 10 day period. Almost everything in
  35. the report is self-explanatory, but a few comments are added in the
  36. brackets [ ].
  37.  
  38.   TMStat Version 3.01
  39.  
  40.   Session time    8:24:33  [how long Telemate is executed]
  41.   Online time     5:07:48  [how long Telemate is online]
  42.   Receive time    1:40:01  [time used for receiving files]
  43.   Send time       0:42:16  [time used for sending files]
  44.  
  45.   Transfer     Receive    Receive    Send       Send        Average
  46.   Protocol     Number     K bytes    Number     K bytes         CPS
  47.   -----------------------------------------------------------------
  48.   Zmodem            4         175         1         180         258
  49.   Ymodem-G          8         620         0           0         282
  50.   -----------------------------------------------------------------
  51.   Total:           12         795         1         180         270
  52.  
  53.  
  54.   BBS Name         Connection   Time   Receive   Send   CPS      LD
  55.   -----------------------------------------------------------------
  56.   SouthWest Connect      15    3:46:02     620    180   277   56.50
  57.   Southern Reaches        3    1:21:46     175      0   253
  58.   -----------------------------------------------------------------
  59.   Total:   2 BBS         18    5:07:48     795    180   270   56.50
  60.  
  61.  
  62.             Telemate Usage Chart             Online  ░░░░░░░░░░
  63.                                             Session  ▒▒▒▒▒▒▒▒▒▒
  64.             ┌──────────────────────────────────────────────────┐
  65.        1.3  │                                              ▒   │
  66.        1.2  │                                          ▒   ▒   │
  67.        1.2  │                                         ░▒   ▒   │
  68.        1.1  │                                         ░▒ ▒░▒   │
  69.        1.0  │                                         ░▒ ▒░▒   │
  70.        0.9  │                                         ░▒ ▒░▒   │
  71.        0.8  │                                         ░▒ ▒░▒   │
  72.        0.8  │                             ▒           ░▒ ▒░▒   │
  73.        0.7  │                          ░▒ ▒   ▒       ░▒ ▒░▒   │
  74.        0.6  │                          ░▒ ▒   ▒       ░▒ ▒░▒   │
  75.        0.5  │                          ░▒░▒  ░▒       ░▒░▒░▒   │
  76.        0.4  │                          ░▒░▒  ░▒       ░▒░▒░▒   │
  77.        0.3  │   ░▒                     ░▒░▒  ░▒      ▒░▒░▒░▒ ▒ │
  78.        0.2  │   ░▒                 ░▒  ░▒░▒ ▒░▒      ▒░▒░▒░▒ ▒ │
  79.        0.2  │ ░▒░▒                 ░▒  ░▒░▒░▒░▒     ░▒░▒░▒░▒░▒ │
  80.        0.1  │ ░▒░▒                 ░▒  ░▒░▒░▒░▒     ░▒░▒░▒░▒░▒ │
  81.    Number   │  1 0 0 0 0 0 0 0 0 0 1 1 1 0 0 0 0 0 0 0 0 0 1 1 │
  82.   of Hours  │  2 1 2 3 4 5 6 7 8 9 0 1 2 1 2 3 4 5 6 7 8 9 0 1 │
  83.             └──────── AM Hours ───────┴─────── PM Hours ───────┘
  84.  
  85.  
  86. The Long Distance Flag in TM.FON
  87. --------------------------------
  88.  
  89. Telemate Version 3.0 has a 'Long Distance' flag in the phone directory.
  90. TMStat checks the flag to determine if it is a long distance phone call.
  91. In the example above, 'Southern Reaches' does not have the flag set in
  92. TM.FON, so the LD field appears blank.
  93.  
  94. IMPORTANT: Edits your phone directory and sets the flags for all long
  95.            distance entries. Otherwise, TMStat will not report the
  96.            LD cost correctly.
  97.  
  98.  
  99. More About Long Distance Charge Calculation
  100. -------------------------------------------
  101.  
  102. Although the /LDnnn.nn option gives you an approximate amount of your
  103. phone bill, you may want to calculate the cost according to the phone
  104. company discount rate in different hour of a day or different day
  105. of a week. In addition, different areas may have differents rates.
  106.  
  107. You can provide these information in the optional TMSTAT.CFG. If
  108. the file is present, TMSTAT.EXE will use it to calculate the long
  109. distance charge. The format of TMSTAT.CFG is as follows:
  110.  
  111. 1. Lines start with a '%' are comments. For example,
  112.  
  113.         % This is my TMSTAT.CFG
  114.  
  115.  
  116. 2. There should be a line starting with '>'. This line is the cost
  117.    specification for all boards unless there is other specification for
  118.    a particular board. This line will be overrided by the 'LDnnn.nn' if
  119.    present.
  120.  
  121.    The format of the cost specification after the '>' is
  122.  
  123.         cost [SAT cost] [SUN cost]
  124.  
  125.    The [SAT cost] and [SUN cost] fields are optional which represent
  126.    the cost specification of Saturday and Sunday respectively.
  127.  
  128.    The <cost> field can be further divided into several sub-fields:
  129.  
  130.         common_cost [the_hour:cost_per_minute] [...]
  131.         common_cost [from_hour-to_hour:cost_per_minute] [...]
  132.  
  133.    The first sub-field is the cost per minute of the day unless
  134.    otherwise specified. For example,
  135.         > 0.4
  136.    denotes a $0.40 per minute for the day.
  137.  
  138.    The following sub-fields are optional. They can be of two formats.
  139.    The first format is
  140.         the_hour:cost_per_minute
  141.    which denotes the cost is <cost_per_minute> for every minute of
  142.    <the_hour>. <the_hour> is in 24 hour format. For example,
  143.         > 0.4 22:0.25
  144.    denotes a $0.40 per minute for the day except the hour from 10:00pm
  145.    to 10:59pm which is $0.25 per minute.
  146.  
  147.    The second format
  148.         from_hour-to_hour:cost_per_minute
  149.    allows you to specify a range of hours. For example,
  150.         > 0.4 0-7:0.25 20-22:0.25
  151.    denotes a $0.40 per minute for the day except the hours from 12:00am
  152.    to 7:59am and 8:00pm to 22:59pm which is $0.25 per minute.
  153.  
  154.    You can mix the two formats in one line. For example,
  155.         > 0.4 0-7:0.25 20-22:0.25 23:0.2
  156.    which is almost the same as the previous example except that it is
  157.    $0.20 per minute for the hour 11:00pm to 11:59pm.
  158.  
  159.    Phone companies usually offer a lower rate on Saturday and Sunday.
  160.    For example,
  161.         > 0.4 SAT 0.3 SUN 0.2
  162.    denotes a $0.40 per minute from Monday to Friday, $0.30 on Saturday
  163.    and $0.20 on Sunday. This is a simple example, but you can apply
  164.    the optional sub-fields to the cost specification of Saturday
  165.    and Sunday too.
  166.  
  167.  
  168. 3. To specify the cost for a particular board:
  169.  
  170.         board name > cost [SAT cost] [SUN cost]
  171.  
  172.    The <board name> should be an exact match with the one in the usage
  173.    file TM.USE. But it need not be in your phone directory TM.FON.
  174.    For example,
  175.         User To User > 0.4 SAT 0.3 SUN 0.25
  176.    denotes the cost specification for the board 'User To User'.
  177.  
  178.    You can have as many specifications as you like.
  179.  
  180.  
  181. For example, the TMSTAT.CFG may look like this:
  182.  
  183.         %
  184.         % > cost [SAT cost] [SUN cost]
  185.         % board name > cost [SAT cost] [SUN cost]
  186.         %
  187.  
  188.         > 0.4 0-7:0.25 20-22:0.25 23:0.2 sat 0.3 0-7:0.25 sun 0.25
  189.  
  190.         PC Connect > 0.4 SAT 0.3 SUN 0.3
  191.         User To User > 0.4 SAT 0.25 SUN 0.25
  192.  
  193.  
  194. With the TMSTAT.CFG, you should be able to compile a more accurate
  195. phone cost report and perpare for the phone bill.
  196.  
  197.  
  198. Tsung Hu
  199. Author of Telemate
  200. White River Software
  201.  
  202.